i ii nj i he iii Sj)ec i irication: 

No new matter is being added to the Specification by the replacement paragraphs. 

Please replace paragraph [0004] with new paragraph |0B04|, shown below.. 
IOO04J Most real-world software systems of any significant complexity are written in more than 
one programming language. For example, an environment may be implemented in Java JAVA™ 
while an interpreted language may be running on top of Java JAVA™ and need to be debugged. 
This situation creates significant difficulties for software developers attempting to debug these 
systems. This problem s s complicated by the fact that there is no standardization in terms of internal 
structures, such as stack frames, between different programming languages. For example, it is not 
uncommon for a developer to see stack information not directly related to the software being 
debugged when encountering a stack frame for one language, when using a debugger intended for 
another language. As another example, when using a debugger intended for the-Java JAVA™ 
language, a Java JAVA™ stack mil not include the stack for XScript (a JavaScript variant with 
native support for extensible markup language (XML)), and can sometimes show the set of Java 
classes that implement the XScript engine (these are part of the environment, but not the software 
the developer is working on). One multi-language debugger, described in Java JAVA™ 
Specification Request (JSR) 45, can only be used to debug languages that are easily transformed into 
Java and then compiled. This and most other multi-language debuggers won't work with languages 
such as XScript where the language will be run by an interpreter or the language can not be mapped 
directly to Java JAVA™ because the language has a different data structure. Thus, creating 
debugging tools that can be applied to software applied to more than one programming language, 
and running in the same environment, has proved to be extremely difficult. 

Please insert the following heading and paragraph [O0O5AJ, prior to paragraph |0006|, as 
shown below. 

BRIEF DESCRIPTION OF THE SEVERAL VIEWS OF THE DRAWINGS 
J0005AJ F1G.1 describes an in.iti.aii < + the invention. 
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Please re] i raph |0006) with new paragraph [0006], shown below. 

1 0006] Systems and methods in accordance with embodiments of die present invention provide a 
debugging environment that can be used by software developers working on multi-language 
s\ steins The t i vironment that can be uniform across languages, 

and can seamlessly perform debugging between one or more languages in a multi-language 
environment. Such a system can have a number of attributes intended to help developers facing 
debugging problems in multi-language environments including: 

• Integrate debugging between two or more languages at the same time, if more that one 
1 anguage appears on a stack, a developer can see the frames for each language, as well as be able 
to inspect variables for each language. 

♦ Nested language debugging. A developer can debug source code that has several nested 
languages within a single source file. Mixing several languages in a single source file is 
becoming an increasingly valuable and popular capability. For example, the emerging 
ECMAScript for XML languages embeds the XML lain ua ■ i\ in FCMAScript. 

* An extensible architecture. Support for additional languages can be added to the multi- 
language debugging environment. For example, using multiple language definitions, a developer 
can perform debugging in the Java JAVA™ language, Xscript language, the Xquery language, 
and various Business Process Modeling languages, such as the Business Process Execution 
Language. 

Please replace paragraph [0007] with new paragraph [0007], shown below. 
[0007] Each language integrated into a multi-language debugger can include specific support for 
the stack frame structures and variable representations used in that language. Each new language 
added to the multi-language debugger can extend the system in at least one of 3 areas: 

• 'The Integrated Development Environment (IDE). If the debugger is associated with an IDE, 
this environment can contain support for the languages supported by the debugger. These 
extensions may include appropriate APIs to get at dialog boxes (watch, locals, stack frame, etc), 
as well as the debugging commands. As an example, many Business Processes Modeling 
languages will simpls be extensions m the IDF: that will map to normal Java JAVA™ code, or 
code in some other complied or interpreted programming language. In these cases, the 
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extensions may be able to simply create extensions to the IDE environment for the underling 
programmi ng language. 

» The Proxy, in one embodiment of the present invention, the proxy is not required. When 
implemented, the proxy may be used to implement user interface (UI) commands into the 
underlying debuggi ng framework requests. The proxy can be used in -process or out-of-proeess. 
In the case where a proxy is out-of-process and used as an intermediate between the 
environment the software is executing in and the debugger, a proxy with the correct mapping 
between the new language and the underling language may be used. For example, to add 
debugging for a new language that maps directly to Java JAVA™ byte codes, the proxy is 
extended to map between the new language and Java JAVA™ . 

• Runtime messaging infrastructure. For some languages the debugger should be capable of 
interacting with the messaging infrastructure. For example, to debug an interpreted language, 
l ike Xscript, the debugging may be done on the server side of the messaging infrastructure. In 
one embodiment, the Runtime messaging infrastructure may interpret language interactions and 
perform debugging in lava JAVA™ Platform Debugging Architecture (JPDA). 

Please replace paragraph [0008] with new paragraph [0008j, shown beiow. 
[0008) Throughout the following di scussion, an example i s developed using the Java JAVA™ 
language. It will be understood that the invention is equally applicable to any programming 
language. This example is presented for illustrative purposes only and is not meant to limit the 
scope, functionality or spirit of any particular embodiment of the invention. 

Please replace paragraph [0009] with new paragraph f0009|, shown below. 
Architectural Overview 

[0009] Some embodiments will be comprised of one or more functional components or modules. 
It will be understood that any particular embodiment of the invention may not require all of the 
components listed, may use additional components, or may use an entirely different organization 
without changing the functionality, scope or spirit. Components used in some embodiments can 
include; 
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A proxy -- In some embodiments a proxy is used between the executing code being debugged 
and the debugger. In some cases, the proxy serves to improve the efficiency or reduce the 
overhead associated with debugging protocols. For example, many Java JAVA™ language 
debuggers use the Java JAVA™ Debugging Interface (JD1), which has a fine-grain API and 
therefore will create a l ot of message traffic between the code under test and the debugger. In 
this case a proxy can consolidate the contents of some of the messages, potentially reducing 
messages and overhead. 

A script engine interface - A script engine can communicate with the multi-language debugger 
through a standardized interface. This interface can be used by the multi-language debugger to 
communicate metadata to the proxy (or possibly directly to the debugger), so the proxy can 
determine when to call into which debuggable language. As an example, for multi-language 
support of JavaScript, a fe« J AVA™ language debugger may define an interface, possibly 
called JdebuggableLanguage, which is used anytime the script engine is invoked. Typically there 
is an object in the Java JAVA™ stack that implements this interface, and can translate the Java 
JAVA™ stack into a JavaScript stack. 

A debuggable frame - For each language supported, the scripting engine may use a debuggable 

frame obj ect. capable of retrieving the script context. As an example a Ja 

debugger may define such a standardized frame, possibly known as IdebuggableFranie. 

An interface to the messaging environment - This is an interface that can be implemented by 

a runtime-messaging environment that controls the running state of the scripting engines. As an 

example, a Java JAVA™ language debugger may define a standardized interface, possibly 

known as IdebugScriptController. 

Script context object - For each language supported, the scripting engi ne can use an object to 
hold a script context As an example, a lava JAVA™ language debugger may define a 
standardized object, possibly known as JcontextHolder. 

A debug commands interface - For each language supported, the script engine can use a 
standardized interface, which the multi-language debugger uses to call into the different 
jl - gjj tblc languages V, an esample a Java 1 V\ V M language debugger may define a 
standardized object, possibly known as IDebugCommands. 
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♦ A script debug controller - A script engine may have a static constructor that loads a script- 
debug controller, which may registers itself upon start-Hp. When the -v»j n'sters itself, 
the script debug controller may get the following information from the engine: a) the language 
extensions for each language, b) the classes that implement the script engine, c) information on 
optional capabilities for the language, and d) the language name. In some cases the controller 
may store this information internally in a map that goes from extension to script engine. As an 
example, for a Java MVA™ language debugger the script debug controller, possibly known as 
Scripti3ebugController, is defined in debugger. jar 

Please replace paragraph [0012] with new paragraph 10012}, shown below 
J0012} In some embodiments, after the script engines have all registered themselves, the script 
debug controller waits until debugging is started. This process is depicted in Fig. 1. Once 
debuggi ng commences : 

1 . The server can send 1 02 an initialization message to the proxy. 

2. The proxy can respond 104 with a packet indicating the languages discovered. 

3 . The server can send 1 06 a language response packet during the boot sequence. This packet may 
include the information used by the script debug controller, such as. a) the language extensions 
for each language, b) the classes that implement the script engine, c) information on optional 
capabilities for the language, and d) the language name. 

4. The proxy will now send 1 08 a message indicating the successful completion of the initialization 
to the runtime massaging server, and will then wait for events. 

Please replace paragraph |0013} with new paragraph [0013}, shown below. 
[0013} In some embodiments, when a breakpoint is hit, or a step is finished in communications with 
the script engine will be to the script debug controller. As an example, with Java JAVA™ code, ail 
communications with the script engines will be through XD1 calls to the script debug controller. 

Please replace paragraph [0014] with new paragraph [0014], shown below. 
[0014} For some embodiments, the first breakpoint hit in the underling language can behave like 
a normal break. The following process may then occur: 
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1 . The debugger gets the current class, line, and stack and processes the stack through a 
language filter. If during processing, the debugger encounters a class that implements a 
script language the following steps may be take: a) if the object derives from a context 
holder, the debug script controller makes a method call to get the context, and b) the debug 
script controller will call a method to get the contents of the stack. Continuing the examples 
fui the fas a f \\ \™ language the debug script cosmoSles will call gett ontext tor some 
other suitable named method) on the I context! lolder object to get the context and then calls a 
method ScriptDebugController.getStack(LanguageExt Context) (or some other suitable 
named method) via JD1, to get a list of scriptFrames. 

2. All script languages are processed as described above, creating a stack frame list to send 
back to the debugger. 

3. The debugger proceeds to discover and inspect variables in the same way as before. 

Please replace paragraph J001 5| with new paragraph [0015}, shown below. 
< ■ cm Frame set to ..Script. .Frame. 

[0015] In some embodiments, the following process may occur if the current stack frame is set to 
a frame controlled by a script engine; 

1, Get the "this" object, and the frame variables and send them to the client as the list of 
variables. 

2. For each object queried, call a method to get the values of the script variables Continuing 
the example for the Java JAVA™ language, a call is made to 
IDebug >i ge get\ ariableQ {or some other suitable named method), to get the 
JScriptVariable (or some other suitable named interface)value. Some possible Java J AVA™ 
language examples of the results of this operation can be seen in the foll owing table. 



Value 

lYW. 


Value Display 


Type Display 


If Expanded 


In Expression 


Simple 


geiVa!ue() 


geiTypeO 




Call 

getPrimativeTypeO to 
determine which get* 
Sunt ti Mi to call to get 
the correct value. 


( o)Wpie\ 


getValueO 


Get TypeO 


Call getMembersQ to 
get the list of members 
to display, then call 


i s«. .t\U nil c to i e! 
members, and 
jllMclhod to call 
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geiMem'berQ one each 
to eet the values. 


method's on the value. 


Array 


gctValueO 


getTypeO 


Create a list 
getLengthO long, and 
populate it with calls 
to tMkkmenn > 


Isv. get! IcmuH to 
lookup the values 


Other 
Language 


Call into the 
ScriplDermgContro 
Her to get a 
resolved 

Script Value and use 
that. 


Call into the 
ScriptDebugCoatraller 
to get a resolved 
Script Value and use 
that. 


Call into the 
ScriptDebugControiier 
to get a resolved 
ScriptVaiue and use 
that 


C all into the 
ScnptDebugCoMroher 
to get a resolved 
ScriptVaiue and use 
that. 


Java 


Call 

getValueObject and 
treat as ordinary 
Java Object 


Call getValtteObjeel 
and treat as ordinary 
Java Object 


Call getValueObject 
and treat as ordinary 
Java Object: 


Call getValueObject 
and treat as ordinary 
Java Object 



Please replace paragraph [0016] with new paragraph [0016], shown below. 
Stepping through code 

[0016] Some embodiments can step though code using a mechanism analogous to that used in an 
ordinary (without multi-language support) debugger, except that the debugger will inform the script 
debug controller when a step is about to begin, in this way, any script engine thai is started, and 
script engines that return from calling into the underling language (e.g. Java JAVA.™) will be able to 
stop appropriately. In some cases, script implementation classes are placed into the excludes -filter 
during a step request. 

Please replace paragraph [0018] with new paragraph {0018], shown below. 
[0018] in some embodiments, when a script breakpoint is hit the following actions can occur: 

* The script controller will call a breakpoint method, sending a message indicating the 
breakpoint hit to the proxy. Continuing the Java JAVA™ language example, the controller 
can call into a method with a name, such as., ScriptDebugController.BreakQ to send the 
message to the proxy. 

♦ The Proxy can then freeze the thread, and perform any required communications. In the Java 
JAVA™ example these communications can use function calls via IDI. 

• When the user decides to continue, the debugger will unfreeze the thread and send a 
Continue, Stepln, StepOver, StepOut, etc., packet as appropriate. 
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Pit st i i raph |0020| with new paragraph [0020], shown below. 

[0020] In some embodiments, when theuser hits Pause, the thread will be paused. The debugger 
can then look to see if the stack is currently in scripting or the underling language (e.g. Java 
.•LAY.A™) code. One of the following actions may then be taken: 

1 . If the stack is in the underling language code, the process is complete In some cases, thi s 
situation is treated in the same way hitting a breakpoint is treated. 

2. If the stack is in script code, a pause method is called on the script engine interface and the 
execution of the scripting language will continue unti l it hits a stopping point, when a pause 
method is called on the script debug controller. Continuing the J-a\ -i 1 \\ V™ langu i e 
example, when a pause() method on the Idebuggabl ©Language interface is called, the 
scripting language will continue until it hits a stopping point, at. which point the engine calls 
ScHptDebugControiler.PauseQ. 

Please replace paragraph (0021 \ with new paragraph [0021], shown below. 
[0021] In some embodiments, when a pause is called on a script language while it is waiting on 
some synchronization object, it will be treated as a normal thread in the underling language (e.g. 
Java JAVA™ ), which can prevent deadlock scenarios. 

Please replace paragraph |G022j with new paragraph [0022], shown below. 
Breakpoints 

[0022] .In some embodiments, informati on i n breakpoint packets can use a suitable extension or 
other indicator to identify the language type being executed. In some cases, the absence of the 
extension can indicate the underling language (e.g. &va JA VA™) is being used If a breakpoint is 
not in the underling language the following actions may be taken: 

1 . Send a message to the script debug controller telling it to set a breakpoint. 

2. The script debug controller will look up the proper extension or indicator and set a breakpoint 
using the method available for that language. 

3. The script debug controller will then send a message indicating the success or failure of setting 
the breakpoint. 
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In some embodiments several types of breakpoints are supported, which can include: 



Source Breakpoints 


This is the ordinary type of breakpoint that goes on a source file/line j 
number I 


|\ lettn d Bi cakp 


Tins bicakpomt ^ f tuhef it t i lis called i 


Watch point 


t cdkpoiiu is hit vJici ic is cithc vid 01 un i 



Please replace paragraph [0024| with new paragraph |0024|, shown below. 
An Exam pie : Interfaces 

[00241 The following examples show sets of interface definitions for two embodiments, 
developed using the Java J AVA™ language. It will be understood that the invention is equally 
applicable to any programming language. This example is presented for illustrative purposes only 
and is not meant to limit the scope, functionality or spirit of any particular embodiment of the 
invention. 



Interface Definition i 



' The script controller will be an object that interopetates with the scripting I; „ ^ 

* to bnnq you scrip* debuqqma The way this will wotk is each lartauag© enqinc will have 

h t tr - iiit' i < c 3e>fc >lte 

* will have list of a!! the <code>!Oebuggab!eUrtguage</code> interfaces. 

public interface IScriptController 

' static mt RESUME CONTINUE = 0; 
state mt RESUME~STEP IN == 1; 

•■ STEP~OUT = 2; 
static int RESUME~STEP~OVER == 3, 
static int RESUME~STOP~= 4: 



[ ■ f 3m frames - should be the frame list for the current script context. 

* ©return the return value tells the scripting engine what command resumed the break, 
public int BreakQ; 

r 

* this is what the scripting lanuguage calls when it's time to pause itself. 

* ©return the return value tells the scripting engine what command resumed the pause, 
public int Pause(int pauselD); 

r 

This is how the 

* engine wili know if the thread is currerrtiy in the middfe of a step or not 



public int Starts .1 
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t ill r th hr< 1 urrently in the middle of a step or not 

- ^return the return value t 

* fn the middle of. 
7 

public int ResumeScriptO; 

r* 

* processes the variable on 

* >needs to process an expn 

public IDebuggabteLartguage.lScnptValue proc8ssScriptVatue(l[)ebLiggablei..aiigu3geJScnptVaiue value); 



public void breakpotntProcessedflDebuggaWeLartguageJBreakpointtnto bpt): 

r* 

* This gets the 1 j < fur the script language specified, using the context specified. 

e are inspecting 



* ^return an array of the stackframes this yeilds 

IDebuggableLanguage.lScriptFramefJ getStack(String langExt.Object context); 



* This interface is used to get a context object for a given frame The way this 

- » 5 that the • . !! qo dovw ? stack frart eking t bjects that 

* derive from IScriptConte'xtHolder When it comes across such a class it will get the 

* context from the frame and pass it to the DebugSaiptController It is possible for 

* many * * ■<-xt In this case, the frame will only 
*$et passed to the DebugScnpK t oi * 

public interface IScriptContextHolder 

public Object getContextQ; 



public interface iDebuggablelanguage 
//These an - hkatur^b 

public static Stung EXPRESSION SUPPORT='0-ebloqic. debugging cornm expressions": 

uq SOURCE BREAKPOINT SUPPoPT debugg mm eakpomf. 



public static String 

METHOD BREAKPOINT 5UPPORT="weblogic debugging cornm methodbreakpoinf': 
public sialic String WATCH POINT SUPPORT=>'ebloqic. debugging cornm watebpoint", 



* "This will be called on each of the debuggable languages before we get rolling, 
public boolean initfJScriptControiier controller); 

/** 

* This will be c tl /e aie ending 
public void exitQ: 



;.. such as org.moziiia 



Stringfj anguagel lifers , 
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* This is a list of the class instances that we can call into to qet variable information, etc. 

* When walkmq through 3 stack trace, we will qo to each of these to ask it to spit out it's stack. We will 

* furthermore When a user inspects this part of the stack we will also ask these objects for variable 
values, etc, 

*/ 

Stringfl Language Framesn; 



* This is a list a* as tances that we can call into to gs > - ^irmation. etc. 

.... .... "' each of f nit its si 

e stack we will s •> objects for variable 



* When walking through a stack ttace. we will goto each of these to ask. it to spit oat it's stack We will 

* furthermore. When a user inspects 'this part of the s*—'' " l - ' -—'->- 



String LanguageNarnef); 

r 

* This is a list of the class instances that we can call into to get variable information, etc. 

' When walking throuqh a stack trace, we will go to each of these to ask it to spit out it's stack. We will 

* furthermore. When a user inspects this part of the stack, vve will also ask these objects for variable 
values, etc. 

7 ' 

St n n g[] L a n g u ag e L :< te n si o n s 0 

r 

* This function is used for dete - 1 , ' . es 1 - . - • t supports, ( 
boolean featureEnabledf String feature); 

/** 

* When pause is called, it is up to the script engine to break at the next possible 

* place. This method can be called v hi the enqine is in teh middle of pro < 
*^so should be treated as a synchronized. 

void pause(Object context, int pauselD); 

// 

//Methods for Inspectinq/dealino with variables 

IScnotValue aetVanabTef Object context. Strma strVar. int stackFrame): 
IScriptValue so T ai abl< (Obit t coi ext String strVar, int stackFrame); 
IScriptValue processExpression(Object context String strExpr, in! stackFrame); 



if points 

IBreakpointinfo setBreakpointi iScnptBreah point bp): 
v 01 d cl ea r S re a k po i nti I S c r i pt B re a k pot nt b p ) : 
void dearAHBteakpointsi) 

public interface IScriptValue 

static final int SIMPLE TYPE * 0; 
static, final int COMPLEX TYPE = 1: 
static final int SCRIPT ARRAY TYPE = 2, 
i rial int OTHER TAN 

ii ^A_LANGUAGE_TYPE = 4; 

r 

'This gets tb< ; c! display to the user. 

String getVa!ue{); 

r* 

" \f this is a language that supports types, this should return the type name of this variable. 
String getTypeNameQ; 
!** 

*^This determines if the variable is a complex type, simple type or other languagy type, 
^ int getAbstractType(); 

public interface ISimpieScriptValue extends IScriptValye 

' public static final mt TYPE BOOLEAN = 0, 
public static final int TYF 5 E~BYTE = 1: 
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i ibl static 1 . PE CT - r 
public static final int TYPE"'D0U8LE = 3: 
public static final int TYPETLOAT * 4: ' 
public static final int TYPE INT = 5; 
public static final int T FE L f J = 6. 
public static final int TYPE'" SHORT - 7. 
public static final int TYPE - STRING = 8. 

t TYPE-NULL = 9; 

public int getPrimativeTypeQ: 

public boolean getBooleantj, 
public byte getBvteid 
public char qetCbarP 
public double ottD.i - 

t 'i tat cMHujti i 
public int getint{); 
public long getLongQ: 
public short aetSbortt) 
^public short getStringQ; 

public interface IScriptArrayValue extends iScriptValue 

' int aetlengthO. 
^IScriptValue getliement{int i); 

public interface IComplexScriptVaiue extends IScriptValue 

v* 

Mf this is a complex type, this will return a list of all it's members. 
List getMerobersQ; 

r 

* if this is a c ptex type, th t "turn a member of it. 
fScriptVaiif© getMembertString name); 



_ method on the t . nethod, it should 

* return a mill Otherwise. oaliMetbod should return a scrtptValue representing tf 

* returned value if thai value is null, this will be a ScnptValue with the value null 

^ iScriptValue callMethod(String name, IScrtptValueO values): 
public interface IGtherlanguageValue extends IScriptValue 

r 

^script extension for this variable. 
Siring getScriptExtensionfj, 

r 

* gets the underlying vaiue object The other scripting language should be able to figure out 

• other Sen pt v a lues f ro m this 

^ Object getValueObjectO; 

public interface UavaValue extends IScriptValue 

V* 

" gets the underlying Java object. The proxy will be able to disect this and keep values, etc for this 
_ Object getValueObjectO. 

public interface IScriptFrame 

r 
*i 
*ii 
*/ 

String getlanguageExtension{); 
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String getDispiayFrame(); 



String getCiassNameO; 



* This is the fine of execution the current frame is on. 
7 

int getLineO, 



List getFrame Va n a bi es 0 ; 



public static final String BREAKPOINT RESOLVED = "0": 

public static final Strtna B R £■■ AK P O t N T~U R R E. SO L V £■■ D == "1", 

public static final String BREAKPOINT_ERRQR = "2"; 

public String getStatusO; 
public int ctetOr ;f!.inei , 

> itrLtneR 
^public IScriptBreakpoint getBreakpoint(); 

public interface IScriptBreakpoint 

public interface IScriptSourceBreakpoint extends IScriptBreakpoint 

String getCiassNameO; 
^ int getLineO; 

public interface I ScriptMethodBreakpoint extends IScriptBreakpoint 

String qetMethod(); 
^ Stringy getPararns(); 

public interface iScriptWatchpoint extends IScriptBreakpoint 
boolean stop6nV\friIe('i; 

} } 

interface Definition 2 

* To change template for new i; 
'Code Style j Class Template' 

package weblogic.debugging.c 
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public interface IScriptController 

public static ctass Languagelnfo implements Serializable 

public Language! nfof String languaqeName String!] lanauageExtensions, String]) fanguageFilters. String]] 
Holders) 

JanguageName = languageName; 

rtguagt tension; > igeExl 
J a nq u a ge F lifers ::: Ian q u a qe Filters; 
m eontextTiclders = contextHolders. 

public final String JanguageName; 
public final Stringf] languageExtensions; 
public final String JanguageFiiters; 
pr r i ' 1 _contexfH riders 

( transient public luebuggableLanguage Jang; 

static tnt RESUME CONTINUE = 0; 

tat 1 ESUMi EF 
static tnt RESUME""STEP""OUT = 2. 
static mt R E S UM £"'STE P'"0 V E R = 3: 
static int R E S U M E~ST O P~= 4; 

r 

* returns a iist that contains Languagelnfo. There will 

* be one for each language. 

Language! nfoQ getLanguages(); 

r 

* This is what a running script will call when it wants to break 1 his is a waitina call. 

h t ad has betn told to continue The f 3 io ps nt.tei should 

* be a list of x1e>IDt \ l guageS!ScriptFrame</code>. 

* ©param frames - should be the frame list for the current script context. 

* ©return the return value te!is the scripting engine what command resumed the break, 
public int BreakQ; 

*thtsiswha ti it i juag j'i m i -hi it's time to pause itseff. 

^return the return value tells the scripting engine what command resumed the pause, 

public int Pause(int pause! D); 



public boolean SfartSenpii }, 

r 

* This is what lot engine n I when resuminq e> ititm. This is how the 

* engine will know if the thread is currently in the middle of 3 step or not. 



public boolean ResumeScriptf); 

r 

- ptValue i ssingit off t pt eng hs >n 1 t 

* will return a new IScritpValue that knows more about that vaiue, 

public IDebuggabieLanguage.lScriptValue processScriptVah ebnggablt * ptValue value); 
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s previously un-reso)vab!e has 

public void breakpointProc.essed(IDebuggableLanguage.!Bf8ai<pointinfo bpi); 
/** 

* This gets in. tack es forth* ptlang w rifled using the context specified 

* @param iangExt - This is the language extension for the language we are inspecting. 
*■ @param context -- This is the-* idfK u ij {testing. 

* ©return an array of the stackf rames this yeilds, 

!Oebuggab!elanguage.lScriptFrame(] getStack* String IangExt Object context); 
package weblogie debugging comm. 

r 

* This interface is used to get a context object tor a given frame. The way this 

> is that tl v Jownth 1 ! for object hat 

* derive from IScriptContextHolder. When it comes across such a class it will qet the 

* context from the frame and pass it to the DebuqScnptController. it is possible for 

* many script frames to all have the same context. In this case, the frame will only 

* get passed to the DebugSeriptController once. 

public interface IScriptContextHolder 
j public Object getContextinstanceO; 

package weblogic.debugging. com m; 
import java.utif.Ust; 



r script at fag is it foes for Java execution. An 



* exception will suddenly be thrown that should km everything You should be careful. 

* that everywhere in your code you rethrow the exception when you qet it instead of qet 
'^processing it. 

public interface IDebuggabieLanguage 
//Ti s« an ? r >'s for each features 

put ; EXPR1 f ' acd 1 ugqing.comm. expressions", 

r - EAl ' 3UPPOF -ebloqic debuooing .cot ireakf 
public static String M ETHOD'" BR E AKPOI NT"'S U P PC R T =' 'we b! e qi c . de bu g qi ng. cornm . methodbrea kpoint" , 
public stati sti no WATCH„PO^NT„SUPPORT= :H webio9ic.debuggtng.comm.watchpoint' , : 

public static int I NVALf D„PAUSE! D * -1; 

/** 

'it - n ending. Pioblem is that ti it 

*^get called in the case of system crashes, etc. 

public void exit{); 



StrmgO Language!'-" iltersO, 

r 

^This is a list of the class instances that we can get a script context from. 
StringO ContextHoiderstj, 

r 

* This is a list of the class instances that we can call into to qet variable information, etc. 

* When walking through a stack trace, we will go to each of these to ask it to spit out it's stack. We will 

' furthermore when a user ins - j r ^sH these objects for variable values, etc. 

String LanguageNameO; 
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* This is a list of the class instances that we can call into to qet variable information, etc. 

* When walking through a stack trace we will ao to each of these to ask it to spit out it's stack. We will 

* furthermore. When a user inspects this part of the stack, we will 

siringQ LanguageExtensionsQ: 



* This function is used for determining what features this debug engine supports . (UNDONE what features should 
we 

* aiiow to be disabled) 

boolean featureEnab!ed( String feature), 

r 

use is call to t it the next possi 

* place This method can be called while the engine is in teh middle of processing 
so should be 1 ed as a syr i 

* ©returns a boolean st f qw the s m ting engine has more work to do in order to pause. 

* if'this returns true, the Proxy will resume the thread, and wait for it to send a message 

* saying it's done, if this returns false, the thread will be suspended as is. 

boolean pause bj« ntext, int pauselD); 

// 



- if i i u 1 / riabfes 

anablei ect cont J , nt stack 

void setVanablelObject context String strV'ar, iScriptValue value int stackhrame'), 
1 Sen ptVal ue processVal ue(l Script Vai tie v aTue}: 

IScrii n(Ob]ed t St > t > o f ' > > 



Jkpoints 

IBreakpomtlnfo setSourceBte3kpoint(Stnnq elazz. int line, ml id): 

M (String clazz ' i r , ^ i > 1 i 

IBreakpointlnfo setWat pc (S inq elasz 3ttmq varName. boolean fStopOnRead boc i 1 



NE }l J >- bstractTvpe ba k to this, to find out wha n ' >hje*tve 

•uid imagine having an object that implemented a 

public interface IScriptValue 

X static final int SIMPLE TYPE = 0: 
tati ma tC MPLE (Pi 
static fma! int SCRIPT ARPAY^TYPE - 2: 
static final int OTHER TANGUA-3E TYPE = 3. 
static final int JAVAJ^NGUAGEJTTPE = 4. 

r* 

'This gets thf i!u« touid splay to the user. 
String getValueO; 

r 

* If this is a language that supports types, this should return the type name of this variable. 

' 1 i ,_ j 1 IlH. j 1 



void setVatuefS t th re Exception; 

r* 

*Tftis determines if the variable is a complex type, simple type or other languagy type, 
int getAbstractTypeO; 

r 

termin >* t e f e is Read Only or not 
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public interface ISimpleScriptValue extends IScrtptValue 

public static fine EAN-Q; 
taticfi >' PE BYT 
ui static final int TYT 
public static, final mt TYPE_DOUBLE = 3. 
public static final int TYPE FLOAT ■■ 4 
public static final irif TYPEObiT = 5: 
public static final mt TYPE" LONG = 6, 
public static final mt TYPE" SHORT = 7, 
, i 1 tic tins . 1 RIN 
public static final jot TYPE~NULL = 9; 

public int getPrimativeTypeO; 

public boolean getBooleanO; 
mblic t 3etB t< 

publ 3! ?Cf '.i 

pu bl icdou bf e qetO o u bl e(i, 
public float getFloati): 
public int get I nip 
public lona "'qetLongO; 
public snort aetShortt s; 
public St tunc 

} 

public interface IScriptArrayValue extends IScriptValue 

int getlengthO; 
^ IScriptValue getfclement(int i); 

public interface IComplexScriptVaiue extends IScrtptValue 

V* 

* there can be complex types that do not have children, 
boolean hasChi!dren(); 

r 

* if this ts a complex type, this will return a list of all it's members. 
List getMembers(); 

r 

I /pe, this will return a member of it 

IScriptValue getMembertString name); 

r 

*sf this is a complex type, this will return a member of it 
void sstMember(String name, IScriptValue val) throws Exception, 



* calls a metbodort the comlex type. If the method is a void method, it should 

* return a null. Otherwise. callMeibod should return a satptValue representing 

* returned value, if that value is null, this will be a ScriptValue with the value n ; 

, t\ akte ca!!Method(String name, IScriptValueO values); 



} 

public interface lOtherlangusgeVslue extends IScriptValue 
/" 

* script extension for this variable 
String getScriptExtensionf); 
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jublic interface IJavaValue extends IScriptValue 



*^ gets the underlying java object. The proxy m\\ be able to disect this and keep values, etc for this. 
Object getValueObject<: ); 



pubiic interface IScriptFrame 

r 

t the 1 * i + it Ian ti 

*lf a language supports more than one file extension, tins will just be one 

String getlanguageExtensionO; 

r* 

II be used to display 

* the stack frame to the user. 
7 

String gethu fiction Nam e( ), 
r * 

; file from. This will be put through the 

. solution process on the ide. 
String getClassNameQ. 

r 

* Thi til be put through the 

* I i e solution process on the ide. 

String getFHeNameO; 

* This is the line of execution the current frame is on 

7 

int gettineO; 
/** 

om the current stack. All the 

" values in the list that are returned will be of type Strona To get a value, you will want 

* Jo call IDebuggabiel.anguage getVanable 

List getFrameVariables(); 



* This function will return an IScriptValue if there is a <code>this</code> object, otherwise it 
' , ill r -turn null. 

7 

IScriptValue getThisQ; 



public interface IBreakpointinfo 

1 public static final String BREAKPOINT RESOLVED = "0". 
public static final String BR E AK POI NT"U MR E SO LVE D = "1", 

public static final String BREAKPQiNTTERROR = "2"; 

■ j ' !i {ring jet 1 itus(i 

public int ^et> 1 it 

public int g<-ti ui \e{) 

public. m{ getld(); 

} 



Please replace paragraph [0025| with new paragraph 10025} , shown below. 
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[0025] As has already been discussed, some embodiments use facilities in the runtime- 
messaging environment to perform debugging operations on network messages. This capability is 
demonstrated here by example shown in the table below developed using the Java JAVA™ 
language. In another embodiment, method calls may be made via the native debugging 
infrastructure JDI. Methods are called on the ScriptController via JDI to do continues and other 
such tasks Breakpoints are exect < >y hi i ctual Jas 1 \ point and ue then 

translated in the proxy to script breakpoi nt. Thus, break poi nts reduce to Java breakpoints. JDI sends 
a message to the proxy in the underlying JDI protocol. For example, a packet may be sent from the 
server to the proxy that includes meia-data. for a scripting language. The meta-data is used to 
determine whether to treat the language as a scripting language or to treat the language as a native 
language. It will be understood that the invention is equally applicable to any programming 
language. This example is presented for illustrative purposes only and is not meant to limit the 
scope, functionality or spirit of any particular embodiment of the invention. 



Message 


Sender 


Meaning 


Parameters 


SetBreakpoint 


Proxy 


Trying to set a script 
breakpoint 


File ~ File name 

Line - Line number 

Language Ext - Language 
Extension 


SetMeihodBreakpoint 


Proxy 


Trying to set a 
breakpoint on a 
method 


Class - Class name (or file name 
is language doesn't have classes) 

Method Name of the method to 
set a breakpoint on 

Parameters - The parameters for 
the method to set a breakpoint on. 
This disambiguates in the case of 
multiple methods with the same 
name but different parameters 

Language Ext™ Language 
Extensions 


BreakpointSet 


Runtime- 
messaging 
environment 


Breakpoint is set 


Status - Did the breakpoint get 
set 

Error -- Error message if it failed 


BreakHit 


Runtime- 
messaging 


A Script hit a 
breakpoint 


File - the file name 
Line - the Sine number 
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environment 






Continue 


Proxy 


A script shouid 
resume 


ContinueType - whether this 
shouid continue with a step or a 
continue 


Pause 


Runtime- 
messaging 
environment 


Telis the proxy a 
script has gotten to a 
safe place and 
paused 


Pause ID ~ This is the ID we use 
to map a pause the thread it was 
requested on. 
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